package com.ruoyi.employee.mapper;

import java.util.List;
import java.util.Map;
import com.ruoyi.employee.domain.HrPersonChange;
import com.ruoyi.employee.domain.HrPersonChangeView;

/**
 * 人员变动记录Mapper接口
 *
 * author hango
 * date 2025-10-19
 */
public interface HrPersonChangeMapper
{
    /**
     * 查询人员变动记录
     *
     * @param id 人员变动记录主键
     * @return 人员变动记录
     */
    public HrPersonChange selectHrPersonChangeById(String id);

    /**
     * 查询人员变动记录列表
     *
     * @param hrPersonChange 人员变动记录
     * @return 人员变动记录集合
     */
    public List<HrPersonChange> selectHrPersonChangeList(HrPersonChange hrPersonChange);

    /**
     * 新增人员变动记录
     *
     * @param hrPersonChange 人员变动记录
     * @return 结果
     */
    public int insertHrPersonChange(HrPersonChange hrPersonChange);

    /**
     * 修改人员变动记录
     *
     * @param hrPersonChange 人员变动记录
     * @return 结果
     */
    public int updateHrPersonChange(HrPersonChange hrPersonChange);

    /**
     * 删除人员变动记录
     *
     * @param id 人员变动记录主键
     * @return 结果
     */
    public int deleteHrPersonChangeById(String id);

    /**
     * 批量删除人员变动记录
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteHrPersonChangeByIds(String[] ids);

    // =================== 基于视图（vw_hr_person_change）可选接口 ===================

    /**
     * 查询人员变动记录列表（视图）
     *
     * 说明：从 vw_hr_person_change 视图查询，返回带部门/岗位/职级名称与可读文案。
     *
     * @param empId  员工ID（可空）
     * @param params 额外参数（支持 params.beginTime / params.endTime，可空）
     * @return 结果集（Map 形式，字段与视图列一致，如 fromPostName/toPostName/opContentGen 等）
     */
    public List<Map<String, Object>> selectFromView(String empId, Map<String, Object> params);

    /**
     * 查询人员变动记录详情（视图）
     *
     * 说明：从 vw_hr_person_change 视图按主键查询单条记录。
     *
     * @param id 人员变动记录主键
     * @return 结果（Map 形式，字段与视图列一致）
     */
    public Map<String, Object> selectOneFromView(String id);

    /**
     * 视图：列表（分页由 RuoYi 控制）；使用 HrPersonChange 携带 empId、params.beginTime/endTime
     * @param query
     * @return
     */
    List<HrPersonChangeView> selectHrPersonChangeViewList(HrPersonChange query);
}
